home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / board / CyberPiPView.lha / CyberPiPView / CyberPiPView.doc < prev    next >
Text File  |  1999-01-28  |  5KB  |  134 lines
  1.                  CyberPiPView
  2.         © 1998/99 by Stephan Rupprecht
  3.               All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  CyberPiPView is copyrighted 1998/99 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the
  12.  program(s) it describes.
  13.  
  14.  
  15. REQUIREMENTS CGFX
  16.  - cybergraphics v3/4
  17.  - cv64/3d gfx-board
  18. REQUIREMENTS P96
  19.  - p96 with *cgxvideo emulation* (v1.38)
  20.  - piv or cv64/3d
  21.  
  22.  
  23. DESCRIPTION
  24.  CyberPiPView is another picture viewer with usage of the
  25.  datatypes. This program uses the videolayer feature of a 
  26.  cv64/3d (you need p96 and a cgxvideo emulation to use
  27.  CyberPiPView in conjuction with a PIV) to display pictures
  28.  in 16bit no matter which resolution the current screen has
  29.  (<=8bit, 15/16/24bit). This means that any picture can be 
  30.  shown in up to 65536 colors even if the current screen just
  31.  has 8 colors. The gfx processors automatically scales the 
  32.  picture to fit on the screen. When the window gets resized,
  33.  the picture will be scaled, too.
  34.  
  35.  
  36. USAGE
  37.  From shell 
  38.  ----------
  39.  FILES/M:    filename(s) or AmigaDOS pattern(s) of the image(s)
  40.                 which shall be shown.             
  41.  REQUESTER/S:    pop-up filerequester even when CyberPiPView was started
  42.         with filenames given.
  43.  PUBSCREEN/K:    name of pubscreen to show the pix on (must be a cgfx one).
  44.  COLORKEY/S:    Normally the video layer is the front most part of the screen,
  45.         so if you move a window in front of the layer, the window
  46.         remains in the background. When using the COLORKEY option
  47.         windows can cover the video layer (see also known problems
  48.         section).
  49.  DELAY/N/K:    Turns slide show mode on, each picture is shown for DELAY 
  50.         seconds.
  51.  
  52.  
  53.  From WB
  54.  ----------
  55.  CyberPiPView can be started ...
  56.  1. As default tool
  57.  2. By multi selection (click on the program icon, then select the
  58.     files to view [hold the shift key down while doing this] and
  59.     finally do a double click to start CyberPiPView).
  60.  3. By a double-click, a requester will pop up then.
  61.  
  62.  The tooltypes REQUESTER, PUBSCREEN, COLORKEY and DELAY are available 
  63.  from wb, too.
  64.  
  65.  The window
  66.  ----------
  67.  You can resize a picture using the sizegadget. Clicking on the closegadget
  68.  terminates CyberPiPView. Pressing the lmb starts displaying the next picture
  69.  in the list (if there's one:), the pointer must be over the picture.
  70.  
  71. KNOWN PROBLEMS
  72.  - Sometimes crashes your machine :( according to F.Mariak
  73.    this could be a hardware problem of the virge S3 chip. Actually,
  74.    Frank doesn't have much documentation on it, so if someone has
  75.    a good documentation on it ...
  76.    It has been reported that the vlayer feature works stable on p96.
  77.  - Downscaling isn't supported by the ViRGE chip, you might get trash
  78.    at a certain picture size. 
  79.  - stripes at the bottom / right border (hardware bug?).
  80.  - When using hi-resolutions you may see flickering stripes, to avoid
  81.    this turn-off (default) the COLORKEY option. Unfortunely deactivating 
  82.    COLORKEY doesn't always help because of the high bandwidth which is
  83.    required. Using CyberPiPView on screens >=15 bit doesn't make much
  84.    sense at all, use CyberView by M.Scheler instead!
  85.  - Please note that you can't grab the contents of a video layer!
  86.  - Not a bug: Please set the MULTIMEDIAMEM tooltype to YES (cvision3d
  87.    driver)! Otherwise you'll get an "out of memory" error.
  88.  
  89.  
  90. HISTORY
  91.  1.0    first public release
  92.  1.1    now checks if a cv64/3d is installed (R. Reiswig),
  93.     didn't close libs when ReadArgs() failed,
  94.     window border no longer covers parts of the pictures,
  95.     added COLORKEY option (see known problems section),
  96.     added DELAY option. 
  97.  1.2    removed some enforcer hits
  98.  1.3    now works with p96 picture.dt (forgot to get a new
  99.     bitmap pointer after remapping).
  100.  1.4    now works with p96 cgxvideo emulation, filerequester
  101.     remembers last path, changed handling of window
  102.  1.5    newer releases of cgxvideo.lib work buffered for both Z2
  103.     and Z3 machines. This slows down CyberPiPView, fixed 
  104.     that problem by changing the way the layer is filled up.
  105.  1.6    newer releases of p96 seem to have a different LibID string
  106.     for their cgfx emulation. That's why cyberpipview failed
  107.     to work with a piv. Fixed that by removing the check for
  108.     a specific gfx-board <reported by several users>. compiled
  109.     with gnuc. v1.5 changes made the program crash on p96.
  110.  
  111.  
  112. SPECIAL THANKS GO TO
  113.  Frank Mariak for his help and reworking the cgfx autodocs and 
  114.  includes ;)
  115.  R. Reiswig for his suggestions.
  116.  Emiliano Esposito for his bug report.
  117.  Jan Britsch and Olaf Krafft for beta testing and reporting bugs.
  118.  
  119.  and to all others who sent me mails ...
  120.  
  121.  
  122. AUTHOR
  123.  
  124. Please send bug reports and ideas to:
  125.  
  126.  Stephan Rupprecht
  127.  Apfeldweg 1
  128.  D44359 Dortmund
  129.  Germany
  130.  
  131.  Send emails to
  132.  
  133.  stephan.rupprecht@gmx.de
  134.